home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_perl.idb / usr / freeware / catman / p_man / cat3 / B::Lint.Z / B::Lint
Encoding:
Text File  |  1998-10-28  |  5.8 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      BBBB::::::::LLLLiiiinnnntttt((((3333))))         22223333////JJJJuuuullll////99998888 ((((ppppeeeerrrrllll 5555....000000005555,,,, ppppaaaattttcccchhhh 00002222))))        BBBB::::::::LLLLiiiinnnntttt((((3333))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       B::Lint - Perl lint
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       perl -MO=Lint[,OPTIONS] foo.pl
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.       The B::Lint module is    equivalent to an extended version of
  16.       the ----wwww option    of ppppeeeerrrrllll. It is named after the program lllliiiinnnntttt
  17.       which    carries    out a similar process for C programs.
  18.  
  19.      OOOOPPPPTTTTIIIIOOOONNNNSSSS AAAANNNNDDDD LLLLIIIINNNNTTTT CCCCHHHHEEEECCCCKKKKSSSS
  20.       Option words are separated by    commas (not whitespace)    and
  21.       follow the usual conventions of compiler backend options.
  22.       Following any    options    (indicated by a    leading    ----) come    lint
  23.       check    arguments. Each    such argument (apart from the special
  24.       aaaallllllll and nnnnoooonnnneeee options)    is a word representing one possible
  25.       lint check (turning on that check) or    is nnnnoooo----ffffoooooooo (turning off
  26.       that check). Before processing the check arguments, a
  27.       standard list    of checks is turned on.    Later options override
  28.       earlier ones.    Available options are:
  29.  
  30.       ccccoooonnnntttteeeexxxxtttt Produces a warning whenever an array is used in an
  31.           implicit scalar context. For example,    both of    the
  32.           lines
  33.  
  34.               $foo = length(@bar);
  35.               $foo = @bar;
  36.           will elicit a    warning. Using an explicit B<scalar()> silences    the
  37.           warning. For example,
  38.  
  39.               $foo = scalar(@bar);
  40.  
  41.  
  42.       iiiimmmmpppplllliiiicccciiiitttt----rrrreeeeaaaadddd    and iiiimmmmpppplllliiiicccciiiitttt----wwwwrrrriiiitttteeee
  43.           These    options    produce    a warning whenever an
  44.           operation implicitly reads or    (respectively) writes
  45.           to one of Perl's special variables.  For example,
  46.           iiiimmmmpppplllliiiicccciiiitttt----rrrreeeeaaaadddd    will warn about    these:
  47.  
  48.               /foo/;
  49.  
  50.           and iiiimmmmpppplllliiiicccciiiitttt----wwwwrrrriiiitttteeee will warn about these:
  51.  
  52.               s/foo/bar/;
  53.  
  54.           Both iiiimmmmpppplllliiiicccciiiitttt----rrrreeeeaaaadddd and iiiimmmmpppplllliiiicccciiiitttt----wwwwrrrriiiitttteeee    warn about
  55.           this:
  56.  
  57.               for (@a) { ... }
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 10/23/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      BBBB::::::::LLLLiiiinnnntttt((((3333))))         22223333////JJJJuuuullll////99998888 ((((ppppeeeerrrrllll 5555....000000005555,,,, ppppaaaattttcccchhhh 00002222))))        BBBB::::::::LLLLiiiinnnntttt((((3333))))
  71.  
  72.  
  73.  
  74.       ddddoooollllllllaaaarrrr----uuuunnnnddddeeeerrrrssssccccoooorrrreeee
  75.           This option warns whenever $_    is used    either
  76.           explicitly anywhere or as the    implicit argument of a
  77.           pppprrrriiiinnnntttt    statement.
  78.  
  79.       pppprrrriiiivvvvaaaatttteeee----nnnnaaaammmmeeeessss
  80.           This option warns on each use    of any variable,
  81.           subroutine or    method name that lives in a non-
  82.           current package but begins with an underscore    ("_").
  83.           Warnings aren't issued for the special case of the
  84.           single character name    "_" by itself (e.g. $_ and
  85.           @_).
  86.  
  87.       uuuunnnnddddeeeeffffiiiinnnneeeedddd----ssssuuuubbbbssss
  88.           This option warns whenever an    undefined subroutine
  89.           is invoked.  This option will    only catch explicitly
  90.           invoked subroutines such as foo() and    not indirect
  91.           invocations such as &$subref() or $obj->meth(). Note
  92.           that some programs or    modules    delay definition of
  93.           subs until runtime by    means of the AUTOLOAD
  94.           mechanism.
  95.  
  96.       rrrreeeeggggeeeexxxxpppp----vvvvaaaarrrriiiiaaaabbbblllleeeessss
  97.           This option warns whenever one of the    regexp
  98.           variables $',    $& or $' is used. Any occurrence of
  99.           any of these variables in your program can slow your
  100.           whole    program    down. See the _p_e_r_l_r_e manpage for
  101.           details.
  102.  
  103.       aaaallllllll      Turn all warnings on.
  104.  
  105.       nnnnoooonnnneeee      Turn all warnings off.
  106.  
  107.      NNNNOOOONNNN LLLLIIIINNNNTTTT----CCCCHHHHEEEECCCCKKKK OOOOPPPPTTTTIIIIOOOONNNNSSSS
  108.       ----uuuu PPPPaaaacccckkkkaaaaggggeeee
  109.           Normally, Lint only checks the main code of the
  110.           program together with    all subs defined in package
  111.           main.    The ----uuuu option lets you include other package
  112.           names    whose subs are then checked by Lint.
  113.  
  114.      BBBBUUUUGGGGSSSS
  115.       This is only a very preliminary version.
  116.  
  117.      AAAAUUUUTTTTHHHHOOOORRRR
  118.       Malcolm Beattie, mbeattie@sable.ox.ac.uk.
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 10/23/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      BBBB::::::::LLLLiiiinnnntttt((((3333))))         22223333////JJJJuuuullll////99998888 ((((ppppeeeerrrrllll 5555....000000005555,,,, ppppaaaattttcccchhhh 00002222))))        BBBB::::::::LLLLiiiinnnntttt((((3333))))
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.      Page 3                        (printed 10/23/98)
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.